Skip to main content

ListBox How To's

How to's for the ListBox guide.

How to Use ListBox?​

ListBox – How to Use It?​

A ListBox displays values—either retrieved from a data source or manually added by the developer—in a list format,
allowing the user to make single or multiple selections.

It is commonly used in form design for selection lists, category lists, multi-assignment screens, and similar scenarios.

How to Add a ListBox to a Form?​

  1. Open the form design screen and navigate to the Toolbox panel.
  2. Find the ListBox component among the available objects.
  3. Drag and drop it onto the form.
  4. When the object is selected, the Property Viewer panel displays:
    • General ( Label , Data Source , Behavior , Appearance)`
    • Events
      sections for configuration.

How to Add Data to a ListBox?​

Listing Data from a Data Source​

A ListBox can be bound to a DataSource:

  1. Open the DataSource property.
  2. Select the desired data provider (e.g., SQL query, API data, database table).
  3. Configure Name and Value fields to determine:
    • The label shown to the user
    • The underlying value used in the form

Adding Manual (Static) Data​

If you prefer not to use a data source, static items can be added:

  1. Click the … (ellipsis) button in the Items property.
  2. In the pop-up window, click Add.
  3. For each item, provide:
    • Value
    • Title
    • Selected
  4. Save your changes.

Enabling Single or Multiple Selection​

By default, a ListBox uses single-selection mode.

To enable multiple selection:​

  • Set the Allow Select All property to Enabled.

When enabled:

  • The user can select multiple rows at once.
  • It is useful for mass-assignment or bulk-operation scenarios.

Bind ListBox to DataSource?​

How to Use ListBox with a DataSource?​

A ListBox can be bound to a DataSource, allowing it to automatically display records from the selected data provider in list form.

Steps​

Add the ListBox to the form​

Toolbox → ListBox → Drag & Drop

Locate the DataSource field in the Property Viewer​

This field determines which data source will populate the ListBox.

Select the DataSource​

Choose the appropriate data source from the dropdown list.

Save and run the form​

The ListBox will automatically load the records from the selected data source.

Notes​

  • If the data source is dynamic, the ListBox may update automatically.
  • When dealing with large datasets or when filtering is needed, Lookup may be a better option.

What is ListBox?​

What Is a ListBox?​

A ListBox is a form object that displays values—either retrieved from a data source or manually added by the developer—in a list format.
The user can select one or multiple items from this list.

ListBox is especially ideal for situations where:

  • Multiple selections may be required
  • The number of options is too high for a ComboBox
  • A wide and clear list should be presented to the user

Features​

  • Supports both single selection and multiple selection
  • Can be populated automatically from a DataSource
  • Supports manual item entry
  • All settings can be configured from the Property Viewer in the development interface

How to Add It to a Form?​

  1. Open the form design screen.
  2. In the Toolbox panel, locate the ListBox component.
  3. Drag and drop it onto the form.
  4. Click the object and configure its settings from the General / Events tabs.

Notes​

  • If multiple selection is required, the SelectionMode property must be enabled.
  • For large data lists, ListBox provides a more user-friendly experience compared to ComboBox.
  • Ensure proper field mapping when using a data source.

How to Use Client Enabled?​

What is Client Enabled?​

Client Enabled is a property that defines whether a form control is active (enabled) on the client side when the form is first loaded.
If it is set to True, the control is immediately usable by the user.
If it is set to False, the control is disabled and cannot be interacted with until a specific condition or rule activates it.

This property is especially useful for controlling the user’s interaction flow and applying dynamic behaviors using the Rule Manager.

What Does It Do?​

The property allows developers to:

  • Control when a form control becomes interactive.
  • Prevent users from entering or changing data until prerequisites are met.
  • Dynamically enable or disable controls based on user input or logic.

Example Scenario — Conditional Activation​

Scenario:
A form contains a checkbox called “I Accept Terms” and a text field called “Signature.”
The goal is to make the “Signature” field inactive until the user checks “I Accept Terms.”

Steps to Implement:​

  1. Select the “Signature” field in the form editor.

  2. In the Properties panel, find the Client Enabled field.

  3. Set the value to False — the field will now be disabled by default when the form loads.

  4. Open the Rule Manager.

  5. Add a new rule:

    Condition:

Action:

  1. Save and publish the form.

Result:​

  • When the form loads, the “Signature” field is disabled.
  • Once the user checks “I Accept Terms,” the field automatically becomes active and editable.

Behavior Summary​

Property StateDescription
TrueThe control is active and ready for user interaction when the form loads.
FalseThe control is disabled at load time and can be enabled dynamically via rules or code.

Notes & Best Practices​

  • Use the Client Enabled property to manage client-side interactivity without requiring server actions.
  • Combine it with Rule Manager to define when and how controls become active.
  • Remember: if server enablement is disabled, the client cannot enable the control even if Client Enabled is set to True.
  • By default, this property is set to True (active).

Summary​

Client Enabled improves form usability by letting developers control when and how users interact with form controls.
It is essential for creating responsive, condition-based form experiences where user actions dynamically change the form’s state.